home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 4 / Meeting Pearls Vol. IV (1996)(GTI - Schatztruhe)[!].iso / Pearls / texmf / doc / latex / base / multitex.txt < prev    next >
Text File  |  1996-06-19  |  6KB  |  171 lines
  1.                LaTeX installation instructions for MultiTeX
  2.  
  3.                              25 January 1996
  4.  
  5. SUMMARY
  6. =======
  7.  
  8. This file contains instructions on how to install LaTeX for MultiTeX on
  9. TOS, MiNT or MagiC.
  10.  
  11. Before reading this file, you should read install.txt, which will
  12. explain how the LaTeX installation works.
  13.  
  14. This file describes:
  15.  
  16.  * How to save any old version of LaTeX.
  17.  
  18.  * How to unpack the LaTeX distribution.
  19.  
  20.  * How to create the LaTeX format.
  21.  
  22.  * How to install the LaTeX files.
  23.  
  24. These instructions assume that you are using the standard directory set
  25. up supplied by the MultiTeX distribution. We hope that, if your system's
  26. set up differs from this then you will be sufficiently familiar with
  27. your system to make the necessary amendments to these instructions.
  28.  
  29.  
  30. SAVING YOUR OLD VERSION OF LaTeX
  31. ================================
  32.  
  33. If you are currently using the old LaTeX version, 2.09, you may wish
  34. to save it before installing the new version of LaTeX.
  35.  
  36. You should make a subdirectory calles latex209 in the MultiTeX directory
  37. (e.g. ...\TEX\LATEX209). Then copy the subdirectories with the styles
  38. and with other input files (normaly STYLES, INPUTS and INITEX) into this
  39. latex209 subdirectory. You should also rename the LaTeX format file
  40. which you use for LaTeX 2.09 (usually latex.fmt into latex209.fmt,
  41. latex.fml into latex209.fml, latexg.fmt into latxg209.fmt and
  42. latexg.fml into latxg209.fml).
  43.  
  44.  
  45. BEFORE UNPACKING THE DISTRIBUTION
  46. =================================
  47.  
  48. You should create some new subdirectories:
  49.   ...\TEX\LATEX
  50.   ...\TEX\LATEX\FD
  51.   ...\TEX\LATEX\LOCAL
  52.   ...\TEX\LATEX\TOOLS
  53.  
  54. Latex needs a number of files to run, for example `article.cls'
  55. contains the `article' document class.  However, these files are NOT
  56. themselves the source files produced by the LaTeX3 Project Team.  We
  57. write documented sources in `docstrip archive files' which can be
  58. unpacked to produce the files that LaTeX needs. For example,
  59. classes.dtx contains the documented sources for all the LaTeX
  60. document classes, including article.cls.
  61.  
  62. The FIRST thing to do is to check whether you need to unpack these
  63. archive files, as follows.
  64.  
  65. Before reading any further, you should check to see whether the LaTeX
  66. distribution you have contains the unpacked files.  You can do this by
  67. looking to see if you have got the file latex.ltx.  If you do, then
  68. you should have all the unpacked files and so you can move on to the
  69. section entitled `Creating the LaTeX format'.
  70.  
  71. The unpacking will create and write files into the current TEXOUTPUTS
  72. directory. This helps to prevent it overwriting existing files or
  73. causing problems with your system files. You should set TEXOUTPUTS at
  74. the TeX-Shell (TSH) to ...\TEX\LATEX2E (menu entry "Parameter|... TeX").
  75.  
  76.  
  77. UNPACKING THE DISTRIBUTION
  78. ==========================
  79.  
  80. The archive files are unpacked by running iniTeX (INITEX.TTP) on the
  81. file unpack.ins. To do this select menu entry "TeX-Projekt|Erzeugen"
  82. and select UNPACK.INS at the file-selector.
  83.  
  84. Note: Using an ATARI ST with 8Mhz this will take about 3-4 hours!
  85.  
  86.  
  87. CREATING THE LATEX FORMAT
  88. =========================
  89.  
  90. You should edit the file TEX_L.OPT at the ...\TEX\FORMATS subdirectory.
  91. Setup the variables to following values:
  92.   mem_max=90000
  93.   pool_size=70000
  94.   trie_size=20000
  95.   font_mem_size=24000
  96. If you have more than 2MB, you may set mem_max to an greater value. If
  97. you only use english hyphenation pattern, you may set trie_size to 16000
  98. only.
  99.  
  100. Setup the Shell to use TEX_L.TTP instead of TEX.TTP and INITEX_L.TTP
  101. instead of INITEX.TTP (menu entry "Parameter|... TeX").
  102.  
  103. To create the LaTeX format, you should run iniTeX on the file
  104. `latex.ltx'. Call menu entry "TeX-Projekt|Erzeugen" and select
  105. LATEX.LTX.
  106.  
  107. A hyphenation file such as `hyphen.tex' is read by this run so it
  108. should be accessible by iniTeX.  It also needs to be able to read the
  109. `.tfm' font files for the basic fonts.  These font files and
  110. hyphenation file(s) should be part of your TeX system.
  111.  
  112. If you want e.g. german-hyphenation-pattern read the documentation of
  113. german or babel package.
  114.  
  115. As result you will get a format file `latex.fml' in the
  116. FORMATS-directory. Enter menu entry "Tex-Projekt|Einstellungen" and set
  117. "Format-Vorgabe:" to "latex" or "LATEX".
  118.  
  119.  
  120. PUTTING THE FILES WHERE LaTeX CAN READ THEM
  121. ===========================================
  122.  
  123. Copy all files with extension FD to the new subdiretory "LATEX\FD". Copy
  124. all files with extension TEX from the unpacked distribution to the new
  125. subdirectory "LATEX".
  126.  
  127. Setup the TEXINPUTS-Variable at menu entry "Parameter|... TeX" to
  128. ".;...\TEX\LATEX\*" (don't write "...\TEX", write the hole name of your
  129. own TeX-directory, e.g. ".;F:\TEX\LATEX\*"). Setup the additional
  130. TEXINPUTS-Path (after "+") to the directory, you saved your old
  131. LaTeX2.09 to (if you have done).
  132.  
  133. Setup the TEXOUTPUS-Variable at menu entry "Parameter|... TeX" to your
  134. TeX-output-directory (e.g. "F:\TEX\OUTPUTS").
  135.  
  136. You have now installed LaTeX!
  137.  
  138.  
  139. CHECKING THAT THE INSTALLATION WORKED
  140. =====================================
  141.  
  142. To make sure that the installation has worked, you should run the new
  143. LaTeX on the document `ltxcheck.tex'.
  144.  
  145. Copy LTXCHECK.TEX to your TEXOUTPUTS-directory. Select LTXCHECK.TEX at
  146. your TEXOUTPUTS-directory as main-document (menu entry
  147. "TeX-Projekt|Hauptdatei") and call TeX (menu entry "Arbeiten|TeX").
  148.  
  149. This will produce a number of messages, each of which should be `OK'.
  150. If any of them are `BAD', then read the notes in texpert.txt.
  151.  
  152. If all the messages are `OK' then you are finished!
  153.  
  154. Note: If you run LTXCHECK.TEX at another directory than TEXOUTPUTS,
  155.       ltxcheck will report not existing errors.
  156.  
  157. FINALLY
  158. =======
  159.  
  160. Note: If you want to process a *.dtx-file. You have to select it as
  161.       main-file and call TeX. Unfortunately the shell deletes the
  162.       extension "dtx". So TeX searches for a *.tex-file, cannot find
  163.       it and asks for the correct filename. You have to type in the
  164.       filename (with extension "dtx") once more.
  165.       If you want to call (La)TeX with doubleclick to a *.tex- or
  166.       *.dtx-file (without typing in the name twice), you may use the
  167.       calltex-program.
  168.  
  169.  
  170. Copyright 1995  Markus Kohm and the LaTeX3 project.
  171.